home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbform.zip / FORM.DOC < prev    next >
Text File  |  1993-02-03  |  9KB  |  218 lines
  1.  
  2.  
  3.       PCBFormFiller v1.1  (c)1993 Accutrak Computer Solutions Inc.
  4.  
  5.         Programming and design - Ryan Kleinfeld & Dick Boorsma.
  6.  
  7.        This software is not free! Feel free to share it with others,
  8.         but if you continue to use it after a period of one month,
  9.                     you are REQUIRED to register it.
  10.  
  11.  
  12.  
  13. However short this document may be, I know the first thing you want to
  14. do is see the program, not the documents.  Just type "FORM .\ SET L"
  15. to run a sample of it in local mode.  (Note that there is a space after
  16. the '.\').  When running this, note that the current password is "PASSWORD"
  17. until you change it.
  18.  
  19.  
  20. What is PCBFormFiller?  It will replace the standard script-style forms
  21. which PCBoard currently offers with a true "Form".  If the user supports
  22. ANSI, he can move around from blank to blank entering data, and always
  23. go back to previous blanks.  The user is allowed to see the full page
  24. BEFORE even entering a single answer.
  25.  
  26. Why have I created it?  After being quite dissapointed that NO ONE knew
  27. of a form filler of its type, I took it upon myself to make one.
  28.  
  29. What are the advantages of using this program?  Looks and originality.
  30.  
  31.  
  32. What is included:
  33. -----------------
  34.  
  35. This version of PCBFormFiller comes complete with two pre-made forms.
  36. One form was designed to replace the "(W)rite user info" command.
  37. The other form was designed for BBSs which offer or require donations
  38. or subscriptions.
  39.  
  40.  
  41.  
  42. The proper syntax for running PCBFormFiller is:
  43.  
  44.         FORM [path to USERS.SYS] [form name] [L]
  45.  
  46.         The first two command line arguements are required, the last
  47.         is optional, and is for Local mode.
  48.  
  49.         I have included a sample USERS.SYS and PCBOARD.SYS file to
  50.         make this demo easy to try out.  Simply type the following:
  51.  
  52.         FORM .\ SET L          or          FORM .\ SUB L
  53.  
  54. Your users should need no instructions, as filling a form is quite self
  55. explanitory.  The only thing you do need to do is add two new commands
  56. to your main menu, and install the two forms as doors.
  57.  
  58. Some features which the current version have are:
  59.  
  60.         ■ Ability to read a default value for a blank from the USERS.SYS file
  61.         ■ Set a default value for a blank manually
  62.         ■ Compare blanks to be sure they are the same
  63.         ■ Compare blanks to be sure they are NOT the same
  64.         ■ Set an echo back character (For blanks like "DOTS WILL ECHO")
  65.         ■ Allow only certain responses to a blank
  66.         ■ Allow only a minimum and a maximum amount of characters in a blank
  67.         ■ Allowing templates for a blank (This is used in the phone number
  68.                 blanks to create the "(___)___-____"  )
  69.         ■ Compatible with PCBoard's color coding scheme (the @X codes)
  70.         ■ Automatic error messages when the user has made a mistake.
  71.                 (These dissapear upon the next keypress)
  72.         ■ Saving info typed into the blanks back to the USERS.SYS file.
  73.         ■ Uses the com port & baud rate read in from the PCBOARD.SYS file
  74.         ■ Internal carrier monitoring routine.  If the user drops carrier,
  75.                 PCBFormFiller will return to PCBoard, and hang up.
  76.         ■ Internal com routines.  No other type of interface is required.
  77.  
  78.  
  79. SETTING UP PCBFormFiller:
  80. -------------------------
  81.  
  82. Setting up PCBFormFiller is just like setting up a door.
  83. If you do not know how to set up a door, please refer to your PCBoard
  84. manual.
  85.  
  86. Each form should be set up as a seperate door with the name of the door being
  87. the exact command you want your users to enter in order to access the form.
  88.  
  89. You must select "YES" to create "USER.SYS" in the door setup for each form.
  90.  
  91. There is no need to have the form filler take up a seperate directory for each
  92. form.  Simply put all the program files in one directory, and let your batch
  93. files take care of which form is run.
  94.  
  95. A sample batch file for the "SET" form would look something like this:
  96.  
  97. Cd\Doors\FormFill      <- change to the directory where PCBFormFiller is
  98. Form C:\PCB\ SET       <- Run the form "SET".  USERS.SYS is in "C:\PCB\"
  99. Cd\PCB                 <- Return to the PCBoard directory
  100. Board                  <- Return to PCBoard
  101.  
  102. Once you have all of your forms set up as doors, you must add the commands
  103. to your main menu.  (If you do not know how to edit your menu, please refer
  104. to your PCBoard manual).
  105.  
  106.  
  107. Since this is the first version of this program which has gone public,
  108. ANY bug reports would be appreciated!
  109.  
  110.                 THE EXCHANGE BBS
  111.                 c/o ACCUTRAK COMPUTER SOLUTIONS
  112.                 511 5th Street South
  113.                 Lethbridge, Alberta
  114.                 CANADA
  115.                 T1J 2B9
  116.  
  117.  
  118. This program may be used for a period of one month free of charge.
  119. If you continue to use this program after one month, you must register it.
  120. In Canada, the registration cost is $12.00.  For U.S. registration, please
  121. enclose $10.00.
  122. Along with registering, you will receive the following benefits:
  123.  
  124.         ■ The latest update of PCBFormFiller
  125.         ■ Custom made SET and REGISTER forms for your BBS - FREE
  126.         ■ No more opening "UNREGISTERED" screen - PCBFormFiller will look like
  127.           part of PCBoard.
  128.         ■ FREE technical support - Phone (403)380-6559 Mon-Fri 1:00p-4:30p MST
  129.  
  130.  
  131. IF YOU WOULD LIKE MORE FORMS...
  132. -------------------------------
  133.  
  134. If you want custom made forms, you must call our BBS at (403)380-6556, and
  135. use the name "REGISTER FORMFILLER" (No password will be asked).  You should
  136. then upload a file containing the following information:
  137.  
  138.         ■ The EXACT form screen you want to be displayed (Either in ANSI
  139.           or PCBoard's @X format)
  140.         ■ The maximum & minimum length of input for each blank
  141.         ■ If the data from the blank should be saved to a data file, we
  142.           need the name.
  143.         ■ If only specific answers are allowed, we need to know what they are.
  144.         ■ Are there blanks that cannot be edited?
  145.         ■ If there should be a default for any blank, let us know.
  146.           (Defaults can be specific strings, or "USERS NAME" etc.)
  147.         ■ Are there blanks that must be the same? Ones that can't be the same?
  148.         ■ Do any blanks need an echo character (Like "DOTS WILL ECHO")?
  149.         ■ Should the data in any blank be uppercased?
  150.         ■ Does the data from any blank need to be saved in PCBoard
  151.           (Like "HOME PHONE #", etc)
  152.  
  153. After uploading this file, leave a (C)omment to the SysOp with your
  154. registration number, your name, and the file name(s) you have uploaded.
  155.  
  156.  
  157.  
  158. When you register, you will get the SET and REGISTER forms custom-made FREE.
  159. Any additional forms will cost $30.00 Canadian or $25.00 in the U.S.
  160.  
  161. As soon as your registration payment is received, we will upload the new forms
  162. and your instant registration number to your BBS (uploaded in your private
  163. section, of course).
  164.  
  165.  
  166.  
  167.  
  168.  
  169. INSTRUCTIONS SPECIFIC TO THE TWO PRE-MADE FORMS...
  170. --------------------------------------------------
  171. The "SET" form was designed to replace the (W)RITE USER INFO command.
  172. On my menu I have phrased the command "(SET) user configuration".
  173. This form should need no further explanation, as it simply lets the user
  174. change his/her configuration.  This form originally let the user change
  175. his FILE TRANSFER PROTOCOL also, but since I have no way of knowing what
  176. external protocols you may have set up, this function has been removed.
  177. If you would like this function on your "SET" form, you can specify this
  178. when getting your form custom made.
  179.  
  180. The "SUB" form was designed for boards which require or accept
  181. donations/subscriptions.  Whenever a user fills this form, a data file
  182. called "REGISTER.DAT" will be created in the PCBFormFiller directory.
  183. The format of the file is as follows:
  184.  
  185. (MM/DD/YYYY)   Users Name
  186. (MM/DD/YYYY)   When to contact them by phone
  187. (MM/DD/YYYY)   What phone number to contact them at (Defaults to home #)
  188. (MM/DD/YYYY)   Where they heard of your BBS
  189. (MM/DD/YYYY)   YES or NO if they want to subscribe or not
  190. (MM/DD/YYYY)   How many months to subscribe for
  191.  .     .     .      .      .      .     .     .
  192.  .     .     .      .      .      .     .     .
  193.  .     .     .      .      .      .     .     .
  194.  .     .     .      .      .      .     .     .
  195.  .     .     .      .      .      .     .     .
  196.  
  197. Future versions may include a data-file reader/editor to make the data files
  198. easier to manage.
  199.  
  200. You will notice that there is a few blank lines at the bottom of this form.
  201. Originally I had posted my subscription rates & address there.  This has
  202. been removed since everyone has different subscription rates.
  203.  
  204. (Note that the only valid answers for "HOW MANY MONTHS TO SUBSCRIBE" are 0-12.
  205. With a custom made form, this can be altered.
  206.  
  207.  
  208.  
  209.  
  210.  
  211. And just like every other program.....
  212.  
  213. No one associated with THE EXCHANGE BBS or Accutrak Computer Solutions can
  214. be held responsible for any loss or damage due to the use or misuse of the
  215. data contained with this program.
  216.  
  217.  
  218.